フラット・ファイル・カタログ・フィード

カタログ・フィードは、パーソナライズされたレコメンデーションの生成と表示に必要なすべての商品情報およびカテゴリー情報をRelevance Cloud に提供します。フィードは、通常 1 日 1 回、リッチレリバンス FTP サーバーにアップロードされます。

カタログ・フィードには複数のファイルが組み込まれており、それらのファイルは、Postgres コマンド経由、MySQL経由、または e コマース・プラットフォームが提供する標準的なエクスポート機能により、カタログ・データベースから簡単に生成できるように設計されています。

フィードのアップロード

フィードの定期アップロードをスケジューリングする前に、先ずサンプル・フィードを生成する必要があります。フィード内容を確認し、URL やその他のデータが正確であるかを確かめてください。ファイルは、BOM（byte order mark）なしの UTF-8 エンコーディングで配信する必要があるので注意してください。チームでフィード内容と構造を確認したら、処理するためにサンプルをリッチレリバンス・インテグレーション・チームに送ってください。テスト・ファイルの処理に成功すれば、所定の時間帯（通常は 1 日 1 回早朝 12 AM～4 AM）にアップロードするために商品ファイルをスケジューリングする必要があります。エクスポートされたすべての関連ファイルが組み込まれた単一の圧縮ファイルをリッチレリバンス FTP サーバーに送信する必要があります（インテグレーション・チームが FTP 証明書を配布します）。

推奨される命名規則

圧縮ファイル※：catalog_full_サイト名_YYYY_MM_DD.zip

商品：product_full_サイト名_YYYY_MM_DD.txt

カテゴリー：category_full_サイト名_YYYY_MM_DD.txt

商品/カテゴリー：product_in_category_サイト名_YYYY_MM_DD.txt

商品/属性：product_attribute_サイト名_YYYY_MM_DD.txt

※注記：ファイルは .zip または .gz で圧縮できます

カタログ・フィード・ファイル

商品カタログは、フォルダ内ではなく zip のルートにある 4 つのファイルで構成されています。

  • product_full_サイト名.txt: サイトで販売中の、レコメンド可能かつレコメンデーションが可能なすべての商品リスト

  • category_full_サイト名.txt: 商品が割り当てられるすべてのカテゴリー・リスト

  • product_in_category_サイト名.txt: 商品にカテゴリーを割り当てます。商品は複数カテゴリーに割り当てできます。

  • product_attribute_サイト名.txt: 商品の属性を定義します。

ファイル仕様

各ファイルの仕様は下記を確認してください。

  • デフォルトのカラム名は下記のリストにまとめられています。修正するには、リッチレリバンス担当者と作業をしなければなりません。

  • ファイルの区切り文字はパイプ（|）であり、必要な別の区切り文字をリッチレリバンス担当者に連絡しない限りはそのままになります。

  • 区切り文字は、フィードの値には使用できません。

注記：カラム・ヘッダーは大文字と小文字を区別します。

product_full_サイト名.txt

名称

カラム・ヘッダー

必須/任意

意味

商品 ID

product_id

必須

リッチレリバンス・ダッシュボードやサイト上の JavaScript インテグレーションに使用する商品 ID。最大文字数は100文字。

商品名

name

必須

サイトのレコメンデーションやリッチレリバンス・ダッシュボードに表示される商品名。最大文字数は 255 文字。空欄の場合、すでにシステムに存在する商品の名前は更新されません。

※※商品親 ID

product_parent_id

任意

子商品の親を指定します。 親が複数ある場合、標準的な値セパレータを使用して記述します。デフォルトは「.」です。セット商品の一部でない商品の場合、親 ID は空欄にします。

単価

price

必須

レコメンデーション生成、価格絞り込み、サイト上のレコメンデーション表示に使用する商品価格。商品価格は実数を指定します。例：8.99

レコメンド可否

recommendable

任意 ※

商品はレコメンド可能ですか？これは、在庫がない商品にレコメンド不可のマークを付けるのによく使用します。商品がレコメンド可能な場合は「true」、レコメンド不可の場合は「false」を指定します。

※サイトでリージョン・ファイルを使用する場合、必須のフィールドになります。この商品詳細フィード・ファイルのレコメンド可否に true を設定し、かつ、商品リージョン・フィード・ファイルのin_stockにtrueを設定した場合のみ、商品はレコメンドされます。レコメンド可否に false を設定した場合、in_stock に何が設定されていようと、その商品はレコメンドされません。

イメージ・パス

image_url

必須

サイト URL はレコメンデーションに商品イメージを表示するために使用します。最大文字数は 255 文字。

詳細ページ URL

link_url

必須

サイト URL は商品レコメンデーションにアイテム・ページへのリンクを張るために使用します。最大文字数は 255 文字。

商品レーティング

rating

任意

商品の総合的な格付け。レーティングの値は数値です。空欄の場合、値は更新されません。デフォルトは -1.0（レーティングなし）です。

レビュー数

num_reviews

任意

レビュー数は商品に対して利用できます。空欄の場合、値は更新されません。また、必ず整数である必要があります。デフォルトは 0 です。

商品ブランド

brand

任意

商品のブランド。最大文字数は 255 文字。

販売価格

sale_price

任意

販売時の販売価格。フィードに販売価格が設定されている場合、販売ルールとしてこの価格を使用します。販売価格が設定されていない場合、販売ルールとして定価を使用します。販売価格を有する商品、有しない商品の両方を扱う場合、後者のフィールドは空欄にしてください。前回のフィードから販売価格を削除するには、販売価格に -1 を設定してください。

開始日

start_date

任意

販売サイト/カタログで製品の購入が可能になった日付を入力してください。

·       新着情報ストラテジーで使用し、ここ数日間で購入が利用できるようになった商品をレコメンドします。詳細は「レコメンデーション・ストラテジー」を参照してください。

·       形式：YYYY-MM-DD

※最低販売価格

sale_price_min

任意

販売価格の最低額。例：8.99。フィールドが空欄だった場合、値に -1 が設定されます。

※最高販売価格

sale_price_max

任意

販売価格の最高額。例：8.99。フィールドが空欄だった場合、値に -1 が設定されます。

最低定価

list_price_min

任意

定価の最低額。例：8.99。フィールドが空欄だった場合、値に -1 が設定されます。

最高定価

list_price_max

任意

定価の最高額。例：8.99。フィールドが空欄だった場合、値に -1 が設定されます。

注記：

※価格は、販売価格を用いて指定する必要があります。価格の最低/最高は、SKUレベルの値付けを処理する方法であり、商品の価格に特定の属性に基づく範囲がある場合（異なるサイズで靴の価格も異なる等）、価格の範囲を表示するためにフィードに加える必要があります。

※※商品親 IDは、アンサンブル機能を使用する場合のみ入力する必要があります。

category_full_サイト名.txt

名称

カラム・ヘッダー

必須/任意

意味

カテゴリー ID

category_id

必須

サイト上の JavaScript インテグレーションやリッチレリバンス・ダッシュボードで使用するカテゴリー ID。最大文字数は400文字。

親カテゴリー

parent_id

必須

親カテゴリーのカテゴリー       IＤ。カテゴリー階層を作るために用い、これを使用してカテゴリーのグループの販売管理を構築できます。親がない場合、フィールドは空欄のままにします。最大文字数は 400 文字。

カテゴリー名

name

必須

レコメンデーションおよびリッチレリバンス・ダッシュボードに表示されるカテゴリー名。この名前は、ストラテジーを表示する際にサイト上でショッパーがわかりやすいカテゴリー名である必要があります。HTML エンティティはシングル・クォーテーションとダブル・クォーテーションをエンコードします。

カテゴリー URL

category_link_url

任意

レコメンデーションのカテゴリーをクリックしたときのユーザーの遷移先

カテゴリー・イメージ URL

category_image_url

任意

カテゴリーのイメージ URL

例：

コピー 
category_id|parent_id|name
1005||Men's
1006||Women's
2005|1005|Jeans
2006|1006|Jeans

product_in_category_サイト名.txt

カラム・ヘッダー

必須/任意

意味

category_id

必須

カテゴリー・ファイルで定義されるカテゴリー ID であり、これに商品が割り当てられる。

product_id

必須

商品ファイルで定義される商品 ID

product_attribute_サイト名.txt

注記：属性の要求仕様を最小限にしか使用しないサイトでは、このファイルは省略できます。

属性値（および多値属性）は、列ベースのフォーマットまたは行ベースのフォーマットでリストを作成できます。ただし、ファイルはどちらか1つの形式でなくてはなりません。システムはヘッダーに基づいてフォーマットを自動的に検知します。

リストには属性値に存在しない区切り文字を使用しなければならず、ファイル内の他の場所で使用されているものをリストの区切り文字にすることはできません。ピリオドを含む値はリストの一部として処理されます（これはデフォルトの動作です）。ピリオドは、リスト内の値を区切ります。ただし、リスト値の区切り文字は、フィード・プロファイルを作成する際にカスタマイズできます。

例：

コピー 
product_id|attr_name|attr_value
a19re119|price_high|336.0

使用不可の名称

下記の名称はすでにリッチレリバンスのシステムで使用しており、属性名に使用することはできません。

  • product_ancestors_id

  • product_brand

  • product_canonical_id

  • product_categories

  • product_end_date

  • product_external_id

  • product_feed_date

  • product_genre

  • product_genre_id

  • product_image_id

  • product_link_id

  • product_name

  • product_num_reviews

  • product_pricecents

  • product_price_range_max_cents

  • product_price_range_min_cents

  • product_rating

  • product_recommendable

  • product_release_date

  • product_saleprice_cents

  • product_sale_price_range_max_cents

  • product_sale_price_range_min_cents

  • product_substitutes

  • product_type

共通属性

マージン

マージンベース・ストラテジーでは、MARGIN属性を使用して、レコメンドされる商品の順番を決定します。

マージンの値は 0 から 100 までの数字で、リテーラー向けに生成したマージンに基づいて商品のランク付けを行います。（0 は最小マージンとして、100は最大マージンとして商品に割り当てられます。）マージンは 10 進法で表現できます。

属性名は大文字と小文字を区別するので、カラム名は attribute.MARGIN になります。

短縮名

属性名「Product Short Name」には特別な機能があります。「Product Short Name」の値と一致する商品同士が一緒にレコメンドされることはありません。これは、2つの類似する商品を並べてレコメンドすることを防ぐために最もよく使用します。

この属性名は大文字と小文字を区別し、単語の間にスペースを必要とします。以下の 2 つは正しい名前です。

Product Short Name

または

PRODUCT SHORT NAME

列ベースのフィードでは、カラム名は以下のようになります。

attribute.Product Short Name

または

attribute.PRODUCT SHORT NAME

列ベース

カラム・ヘッダー

必須/任意

意味

product_id

必須

商品ファイルで定義される商品 ID

attribute.[attribute key1]

必須

1 番目の一意となる属性キー

attribute.[attribute key 2]

必須

2 番目の異なる属性キー

…

 

 

attribute.[attribute key N]

必須

N 番目の異なる属性（N=異なる属性キーの数）

例:

コピー 
product_id|attribute.color|attribute.size|attribute.fabric
100|blue|medium|cotton
101|red|large|wool

行ベース

カラム・ヘッダー

必須/任意

意味

product_id

必須

商品ファイルで定義される商品 ID

attr_name

必須

一意となる属性キー。HTMLエンティティはシングル・クォーテーションとダブル・クォーテーションをエンコードします。

attr_value

必須

属性名。HTMLエンティティはシングル・クォーテーションとダブル・クォーテーションをエンコードします。

例：

1 行内の行ベース属性フィードのフォーマット（区切り文字は設定可能ですが、列の区切り文字とは別にする必要があります）。

コピー 
product_id|attr_name|attr_value
100|color|red 
100|size|s

各行で多値属性を通過させる例（リスト値の区切り文字は、フィード・プロファイルを作成する際にカスタマイズできます）

コピー 
product_id|attr_name|attr_value
100|size|xl
100|color|green
100|size|m
100|color|blue
100|color|red
100|size|s,xs
100|size|l